home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / cidv122.zip / CIDLOG.DOC < prev    next >
Text File  |  1992-12-09  |  19KB  |  536 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17. C I D L O G
  18.  
  19. ────────────────────────────────────────────────────────────────────
  20.  
  21. Program Reference Manual
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                Copyright (C) 1992 by Steven L. Davis.
  43.  
  44.                          ALL RIGHTS RESERVED.
  45.  
  46.  
  47.  
  48.  
  49.                  
  50.                     Steven L. Davis SLD Systems,
  51.  
  52.       1143 Washington Green, Building M, New Windsor, NY 12553
  53.  
  54.                  (914) 562-1450 / (914)56201722 BBS
  55.  
  56.  
  57.  
  58.     
  59.     
  60.     CIDLOG v2.22                                        COPYRIGHT ii
  61.     
  62.  
  63.  
  64.                           Copyright Notice
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CIDLOG is Copyright (c) by Steven L. Davis.
  71.  
  72. This document is Copyright (c) by Steven L. Davis.
  73.  
  74. No parts of CIDLOG or  this  document  may  be  copied in part or in
  75. whole,  except as provided  in  the  License  at  the  end  of  this
  76. document.
  77.  
  78.  
  79. Disclaimer
  80.  
  81. Steven  L.  Davis  and  SLD  SYSTEMS  makes no warranty of any kind,
  82. either express or  implied,   including  but  not limited to implied
  83. warranties of merchantability and fitness for a particular  purpose,
  84. with respect to this software and accompanying documentation.
  85.  
  86. IN  NO  EVENT SHALL STEVEN L. DAVIS OR SLD SYSTEMS BE LIABLE FOR ANY
  87. DAMAGES (INCLUDING DAMAGES FOR  LOSS  OF BUSINESS PROFITS,  BUSINESS
  88. INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS)
  89. ARISING OUT OF THE USE OF OR INABILITY  TO  USE  THIS  PROGRAM,   OR
  90. INFORMATION IN THIS DOCUMENT, EVEN IF STEVEN L. DAVIS OR SLD SYSTEMS
  91. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  92.  
  93.  
  94. Trademarks
  95.  
  96. CIDLOG is a trademark of SLD SYSTEMS.
  97.  
  98. Many  product  names  found throughout this manual are trademarks of
  99. various companies.
  100.  
  101.          
  102. CIDLOG V1.22                                          
  103.  
  104. Caller ID Logging system version 1.22
  105.  
  106. Caller ID has brought a  great  resource to the BBS community.   And
  107. with the help of this program maximus can  take  advantage  of  this
  108. resource.  Not only will it log incoming calls, but it will automate
  109. part  of  the  login  process,  and give the bbs the ability to give
  110. personalized greetings to users, and remove the need for the user to
  111. identify him or her self upon connecting to your system.
  112.  
  113. The main purpose of this software is to add caller id support to the
  114. maximus BBS system.   However it  has  been written so that parts of
  115. this program could be easily adapted to other bbs systems,  as  well
  116. as other non BBS uses!
  117.  
  118. What will it do?
  119.  
  120.  o The CIDLOG(tm) Caller ID LOGGER system will log all calls.
  121.  o If you wish, It can allow you to reject callers who BLOCK CALL ID
  122.  o IT can identify the user and automate part of the MAXIMUS login. 
  123.  o It can verify a user without the need for callback verification. 
  124.  o Will not effect incoming calls from areas without caller ID
  125.  
  126.  
  127. What do you need to use this software?
  128.  
  129.  o first off you must have Caller ID service from the phone company.
  130.  o you will need either a modified CALLER ID box (Modification adds
  131.    a serial interface to the caller id box) or a bell 202 compatible
  132.    modem (this may also require a slight modification) more on the
  133.    modifications later.
  134.  o for this version, you will be required to run a multitasking
  135.    system like desqview.  No TSR version has been provided here.
  136.  
  137.  
  138. The CIDLOG(tm) system consists of the following files:
  139.  
  140. CIDLOG.EXE  - Caller ID Logging program.
  141. CIDFU.EXE   - Maximus find user program.
  142. CIDCN.EXE   - Used for user verification.
  143. LOGO.MEC    - Sample LOGO file, displays users name and 
  144.              automates the name entry.
  145. CHKPHO.MEC  - Sample user verification using CIDCN.EXE
  146. CIDLOG.DOC  - This File
  147. LICENSE.DOC - License Info
  148.  
  149. Program descriptions:
  150.  
  151. CIDLOG.EXE(tm) 
  152. this program monitors  the  serial  port  for  incoming  CALL ID and
  153. maintains 3 files in the current directory:
  154.  
  155. CALLID.LOG  - Logs time date and phone number if incoming calls
  156. NUMBER.DAT  - Number of last incoming call 
  157. PRIVATE.DAT - File is created if  the  incoming  call  has  call  id
  158.               blocked
  159.  
  160.  
  161.  
  162. When  a  call  arrives,   CIDLOG.EXE  logs  the  incoming  calls  to
  163. CALLID.LOG log file.  The phone number is also written to NUMBER.DAT
  164. as well over writing any data that may have previously been in  that
  165. file (if it doesn't exist then it will be created).  If the incoming
  166. call has CALL ID blocked, then the file PRIVATE is created.   if the
  167. incoming  call  DOES  NOT have CALL ID blocked,  then PRIVATE.DAT is
  168. deleted.  sample CALLID.LOG
  169.  
  170. DATE: 11/22  TIME: 10:30  PH#: (914) 562-1722
  171. DATE: 11/22  TIME: 10:42  PH#: (914) 562-1450
  172. DATE: 11/22  TIME: 11:01  PH#: Out of AREA 
  173. DATE: 11/22  TIME: 11:33  PH#: Private
  174.  
  175. As you can see there is one  other possible call type,  OUT OF AREA,
  176. which means that the call is coming from an area that  doesn't  have
  177. caller id service.   In the case of this type of call being received
  178. the  NUMBER.DAT  file  will  have the text 'Out of Area' in it,  and
  179. PRIVATE.DAT will be deleted if it exists.
  180.  
  181. The Syntax for running CIDLOG is  CIDLOG  #  Where # is the com port
  182. number that your device for receiving caller id  data  is  attached.
  183. For com2: it would started with this command: 
  184.  
  185. CIDLOG 2
  186.  
  187.  
  188. CIDMFU.EXE(tm)  -  Caller  ID  Maximus Find User.   This is the only
  189. maximus specific .EXE file  included with this release.   CIDMFU(tm)
  190. is designed to be called from maximus from the LOGO.BBS  file.    it
  191. reads  the  NUMBER.DAT  file created by CIDLOG.EXE and tries to find
  192. the user record for the first record with that number.   if the user
  193. record does exist then MAXFU will create 2 files:
  194.  
  195. USERNAME.DAT - raw name for use in logo screen
  196. POKENAME.DAT - A  mecca  token  file that pokes the  users name into
  197.                maximus
  198.  
  199. The POKENAME.DAT file can be linked  into  the logo file so the logo
  200. screen the user will see can  display  his  name  before  he  enters
  201. anything.  The second file is a mecca file which when linked to will
  202. pass the users name to maximus so it is as if the user typed it.  (a
  203. sample  logo.mec  file  is  included) All the files that are used by
  204. CIDMFU(tm) must be in the current working directory.   All files and
  205. created by CIDMFU(tm) are created in the current working directory.
  206.  
  207.  
  208. CIDCN.EXE<tm> this file  compares  the  NUMBER.DAT  file with a file
  209. written by a mecca file called CHKPHO.DAT,  if the phone  number  in
  210. NUMBER.DAT  matches  the number in CHKPHO.DAT then a file is created
  211. called PHONEOK.DAT.   All files  are  used  by  CIDCN must be in the
  212. current working directory.   All files and created by CIDCN<tm>  are
  213. created in the current working directory.
  214.  
  215. Initially CIDCN.EXE program was created to use in place of call back
  216. verification,   however this program doesn't do any duplicate number
  217. checking in the user.bbs  file.    if  there is sufficient interest,
  218. then I will add this.
  219.  
  220. The reason for  passing the number in a file instead of directly  to
  221. the  program  via  a  mecca  command  is  that  i wanted to give the
  222. flexibility for use  in  other  applications.   I.E perhaps checking
  223. against a bad phone number file.
  224.  
  225.  
  226. INSTALLATION
  227.  
  228. FOR MAXIMUS:
  229.  
  230.  
  231. Since caller ID comes in between the first and  second  rings,   you
  232. will most likely need to change your configuration.   To the best of
  233. my knowledge, maximus picks up only on the first ring, Therefor, you
  234. will need to comment out the RING command in MAX.CTL and set up your
  235. modem to auto answer on the second ring.   you can typically do this
  236. by  either  adding  ATS0=2  to your init sequence or programming the
  237. mode m with this parameter and saving it using AT&W command.
  238.  
  239. Installation is very straight forward.   unarc the files,  and place
  240. all the .EXE files in  your  maximus sub directory.   Use the sample
  241. logo.mec file to create your new logo screen (you may need to change
  242. the directory names used in the sample  logo.mec  file).    generate
  243. your logo.bbs using the mecca program.
  244.  
  245. If you want to validate new users then add a link to the  CHKPHO.MEC
  246. file from one of the files you display to new users.
  247.  
  248. Connect your Caller ID receiving device to a free com port.
  249.  
  250. using your favorite multitasker, run CIDLOG specifying the number of
  251. the com port in the command line.
  252.  
  253. NON MAXIMUS Installations:
  254.  
  255. As  far  as  how you will use the programs described above,  that is
  256. totally up to you.    The  CIDLOG.EXE  program will log all incoming
  257. calls to a file and the screen.   It is a  great  addition  for  any
  258. usage,  for bbs applications you will need to run CIDLOG.EXE under a
  259. multitasker, so you may also run the bbs.  I'm greatly interested in
  260. how people are using this software, so please feel free to drop me a
  261. note  or  a  line  and  tell me what applications or situations your
  262. using it in!
  263.  
  264.  
  265. CALLER ID Reception:
  266.  
  267. How do I receive caller ID data.
  268.  
  269. Most of us do not have modems that can receive caller id data.
  270.  
  271. Caller ID data arrives between  the  first and second rings.   it is
  272. transmitted via  BELL  202  type  tones,   and  can  be  demodulated
  273. (received) using any device that can demodulate these tones (I.E.  a
  274. bell 202 style modem or a caller ID box).
  275.  
  276. We care currently arranging to get inexpensive interfaces for CALLER
  277. ID.   However at the moment there are two ways,  that I known of, to
  278. receive  caller ID to your computer without a special interface or a
  279. special modem.
  280.  
  281. One fairly easy method is  to  modify  a  caller id box,  here is an
  282. example of a mod for a standard AT&T model 125 caller ID box which I
  283. use on my own BBS.
  284.  
  285.  
  286. NOTE:  The following modifications are included in this document for
  287. informational purposes.  Use this information at your own risk.
  288.  
  289.  
  290. MOD for AT&T Caller id box MODEL 125c
  291.  
  292.  
  293.                                     232 Ground
  294.                                     DB25 pin 3
  295.                                          ^
  296.                      ---------           |           ---------
  297.                    [|8       7|]---------+         [|1      14|]
  298.                     |         |          |          |         |
  299.                    [|9       6|]         |         [|2      13|]
  300.                     | MC 1488 |          |          | XR 2211 |
  301.                    [|10      5|]         |         [|3      12|]
  302.                     |         |          |          |         |
  303.                    [|11      4|]         +---------[|4      11|]
  304.                     |         |                     |         |
  305.                    [|12      3|]----> 232 OUT to   [|5      10|]
  306.                     |         |       DB25 pin 3    |         |
  307.                    [|13      2|]---------+         [|6       9|]
  308.                     |         |          |          |         |
  309.                  +-[|14      1|]-+       +---------[|7       8|]
  310.                  |   ---------   |                   ---------
  311.                  |               |
  312.                +12v            -12v
  313.  
  314. Turn the caller ID box over,  with the  battery  compartment  facing
  315. you.    remove  the 4 screws covering the back of the 125c caller ID
  316. box.   Locate the XR2211 chip in  the lower right side of the caller
  317. id box.   connect pin 7 of the xr2211 to the input of a  232  driver
  318. (pin  2).   connect the ground of the xr2211(pin 4) to the ground of
  319. the 232 driver(pin 7) connect  the  output  of  the 232 driver to an
  320. RS232 cable (pin 3 on a db25).  connect the signal ground of the 232
  321. driver(pin 7) to the signal ground of the rs232 cable (pin 7 on a db
  322. 25) apply power to your 232 driver, and that's it.
  323.  
  324.  
  325. (USER REPORTED MOD) MOD for a 202 style modem.   (authors  note:   I
  326. have not personally tried this,  however it appears to me as it will
  327. work  as described to me.   I'm looking for comments from anyone who
  328. has tried this or other  mods  /  methods of demodulating caller id
  329. data)
  330.  
  331. If you can find or have a 4 wire 202 style modem, attach the receive
  332. lines to the incoming phone lines via a .1uf capacitor rated  at  at
  333. least 300V.  (a note for you electronic wizards: this keeps the line
  334. DC  isolated  so the line will not go off hook when connected to the
  335. modem.   WV of the cap needs  to  be  high enough to handle the ring
  336. voltage without arcing )
  337.        
  338.               .1uf          
  339.               300WV          | 
  340.   T ------------||---------->| Modem incoming 
  341.                              | Receive phone 
  342.                              | Input Line 
  343.                              | 
  344.   R ------------------------>| 
  345.                              |
  346.  
  347.  
  348.  
  349. We are interested in any additional modifications that might  be  of
  350. interest to those who wish to capture caller id information, so that
  351. we  may pass this information on to others.   Please if you have any
  352. additional mods, or comments on these mods, contact us.
  353.  
  354.  
  355. Version History:
  356.  
  357. V1.22 Multitasker Support, Significant improvments to
  358.       performance under dos and most multitaskers and networks.
  359.  
  360. V1.12 Added addidional logging and maximus support 
  361.  
  362. V1.00 Initial release 
  363.  
  364.  
  365. Who are we?
  366.  
  367. SLD Systems 1143 Washington Green Building M New Windsor, NY 12553
  368.  
  369. Providing consulting services for  both hardware and software needs.
  370. custom programming and system design.
  371.  
  372. For a $5.00 US dollars,  you can register your version of CIDLOG(tm)
  373. V1.22.   Registering your copy of CIDLOG(tm) will  help  us  improve
  374. this software, and entitles you to free updates from our bbs.
  375.  
  376. Please   contact   us   for   additional   information   on  support
  377. arrangements.
  378.  
  379. Please feel free to leave comments on our BBS on possible updates to
  380. this software.   If there is sufficient interest in changes, then we
  381. will include them in a future release of the program.
  382.  
  383. The author can be reached at:
  384.  
  385. Steven L. Davis
  386. 1143 Washington Green
  387. Building M
  388. New Windsor, NY 12553
  389.  
  390. VOICE: (914) 562-1450 
  391.   BBS: (914) 562-1722
  392.  
  393. Comuserve: 70562,540
  394.   
  395. Echomail: Maximus ECHO
  396.  
  397. Fidonet:  1:272/38 (this is not my  node,  however the sysop of this
  398.                   node has been kind enough to accept mail  for me.)
  399.  
  400.  
  401.  
  402.  
  403. CIDLOG v1.22                                               License i
  404.  
  405.  
  406.  
  407.  
  408.  
  409.                                LICENSE
  410.  
  411.  
  412.  
  413.  
  414.  
  415. CIDLOG is Copyright (c) 1992 by Steven L. Davis
  416.  
  417. CIDLOG is not, nor has ever been, public domain or free software.
  418.  
  419. The  commercial,  registered version of CIDLOG may not be duplicated
  420. other than for backup purposes.  A registered copy of CIDLOG must be
  421. treated like a book,  in that the same registered copy of CIDLOG may
  422. not be used in more than one  computer  at the same time,  just as a
  423. book may not be read by more  than  one  person  at  the  same  time
  424. (without making an illegal copy).
  425.  
  426. Users are granted a limited license to use the User Supported, trial
  427. version  of CIDLOG for a limited evaluation period of up to 30 days,
  428. in order to determine if  it  suits  their needs.   Any other use of
  429. CIDLOG or use past this period requires registration.
  430.  
  431. All users are granted a limited license to copy the  User  Supported
  432. version of CIDLOG only for the purpose of allowing others to try it,
  433. subject to the above restrictions as well as these:
  434.  
  435.      CIDLOG must be distributed in absolutely unmodified form,
  436.      including ALL program, documentation, and other files.
  437.  
  438.  
  439. CIDLOG  may  not  be  included with any other product for any reason
  440. whatsoever without a license from Steven L. Davis and SLD Systems.
  441.  
  442.      No charge or payment may be levied or accepted for CIDLOG.
  443.  
  444. Bulletin Board system  operators  may  post  the unregistered,  User
  445. Supported version of CIDLOG on their BBS for  downloading  by  their
  446. users  without  written  permission only if the above conditions are
  447. met,  and only if no special  fee  is necessary to access the CIDLOG
  448. files (a general fee to access the BBS is ok).
  449.  
  450. Distributors of User  Supported  and  Public  Domain  software  MUST
  451. obtain  written  permission from Steven L. Davis before distributing
  452. CIDLOG and must follow the  above conditions.   Permission is almost
  453. always granted;  this requirement is necessary to ensure  protection
  454. for ourselves and CIDLOG users from unscrupulous individuals.
  455.  
  456. The  following  section  contains  information  on  registration and
  457. licensing.
  458.  
  459. CIDLOG v2.22                                              License ii
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                CIDLOG Ordering/Registration Information
  466.  
  467. Registering (buying) CIDLOG allows you  to use the product after the
  468. trial period.
  469.  
  470. CIDLOG version 1.22 registration costs $5 US / $6 CDN.   A disk with
  471. the current copy of CIDLOG on it is also available for $10 US /  $12
  472. CDN.    CIDLOG,   and includes registration (the right to use CIDLOG
  473. after  the  evaluation  period).    The   fee  covers  the  cost  of
  474. diskette(s) and handling.
  475.  
  476. Payment may be in the form of check or money order,  All  US  dollar
  477. checks  must  be drawn on a US bank,  and all Canadian dollar checks
  478. must be drawn on a Canadian bank.
  479.  
  480. Previously regis tered owners of  CIDLOG may use the 1.22 evaluation
  481. release at no charge.
  482.  
  483.  
  484. Shipping is $2 per copy,  to a maximum of $20 in North America,  and
  485. $3 per copy to a maximum of $24 outside of North America.
  486.  
  487.  
  488. CIDLOG v1.22                                             License iii
  489.  
  490.  
  491. CIDLOG version 1.22                                      #921209-122
  492. --------------------------------------------------------------------
  493. Remit to: Steven L. Davis,
  494.           SLD Systems, 
  495.           1143 Washington Green
  496.           New Windsor, NY 12553
  497.           USA
  498. --------------------------------------------------------------------
  499. Quan       Item                              US/CDN        Price
  500.  
  501. ___  CIDLOG Registration................   @ $5/$6 ea     $________
  502.     (registration of Version 1.22)
  503.  
  504. ___  CIDLOG Registration and Disk.......   @ $10/$12 ea   $________
  505.        (includes program on disk + registration)
  506.  
  507.      Disk media type: 5.25" [ ] 3.5" [ ]
  508.  
  509.  
  510.        Shipping/Handling is: ------------------> Shipping $________
  511.          N. America: $2 per disk ($20 max) 
  512.          Overseas : $3 per disk ($24 max)
  513.           
  514.                                                Subtotal   $________
  515.  
  516.  
  517.                                                   TOTAL   $________
  518.  
  519. --------------------------------------------------------------------
  520.              Payment by: ( ) Check or MO   (= ) PO # ____________
  521.  
  522.       Name_______________________________________________________
  523.  
  524.    Company_______________________________________________________
  525.  
  526.    Address_______________________________________________________
  527.  
  528.           _______________________________________________________
  529.  
  530.  
  531.    Phone(______)________________  Other(______)________________
  532.  
  533.  
  534.  
  535.  
  536.